docs: inputs: add thread.ring_buffer.retry_limit option by jinyongchoi · Pull Request #2363 · fluent/fluent-bit-docs

jinyongchoi · 2026-01-28T00:50:10Z

Add documentation for the new 'thread.ring_buffer.retry_limit' configuration option to the following input plugin pages:

tail
opentelemetry
prometheus-textfile
blob

This option controls the maximum number of retry attempts when the ring buffer is full before dropping data. Each retry waits 100ms (hardcoded). The default value is 10.

Refs: fluent/fluent-bit#11394

Summary by CodeRabbit

Documentation
- Added the thread.ring_buffer.retry_limit configuration to multiple input plugin docs. Describes the maximum retry attempts when the ring buffer is full, 100 ms wait between retries, and a default value of 10.

coderabbitai · 2026-01-28T00:50:30Z

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

@coderabbitai resume to resume automatic reviews.
@coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

▶️ Resume reviews
🔍 Trigger review

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 0b87e680-5354-4132-8306-ff5e83b361f6

📥 Commits

Reviewing files that changed from the base of the PR and between 3e27ed9 and 4551cf0.

📒 Files selected for processing (4)

pipeline/inputs/blob.md
pipeline/inputs/opentelemetry.md
pipeline/inputs/prometheus-textfile.md
pipeline/inputs/tail.md

✅ Files skipped from review due to trivial changes (4)

pipeline/inputs/tail.md
pipeline/inputs/opentelemetry.md
pipeline/inputs/blob.md
pipeline/inputs/prometheus-textfile.md

📝 Walkthrough

Walkthrough

Documentation updates to four input plugin guides adding the thread.ring_buffer.retry_limit configuration parameter; no runtime code or control-flow changes.

Changes

Cohort / File(s)	Summary
Thread ring buffer docs `pipeline/inputs/blob.md`, `pipeline/inputs/opentelemetry.md`, `pipeline/inputs/prometheus-textfile.md`, `pipeline/inputs/tail.md`	Added documentation for `thread.ring_buffer.retry_limit`: maximum number of retry attempts when the ring buffer is full; each retry waits 100 ms; default `10`.

Sequence Diagram(s)

(omitted)

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related PRs

fluent/fluent-bit-docs#2320: Adds thread.ring_buffer configuration documentation for Tail input (related thread.ring_buffer docs).
Updated tail input plugin for new long truncated lines options, also added missing options fixing #2202. #2222: Related Tail input documentation table edits.

Suggested labels

4.2

Suggested reviewers

alexakreizinger
cosmo0920

Poem

🐇 I hopped through tables, neat and bright,
Counting retries in the quiet night,
Ten little taps at a hundred ms beat,
I note each pause and make it neat,
Then bound along—docs tidy, light.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title accurately describes the main change: documentation additions for a new thread.ring_buffer.retry_limit configuration option across four input plugin pages.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

Create PR with unit tests

Tip

💬 Introducing Slack Agent: The best way for teams to turn conversations into code.

Slack Agent is built on CodeRabbit's deep understanding of your code, so your team can collaborate across the entire SDLC without losing context.

Generate code and open pull requests
Plan features and break down work
Investigate incidents and troubleshoot customer tickets together
Automate recurring tasks and respond to alerts with triggers
Summarize progress and report instantly

Built for teams:

Shared memory across your entire org—no repeating context
Per-thread sandboxes to safely plan and execute work
Governance built-in—scoped access, auditability, and budget controls

One agent for your entire SDLC. Right inside Slack.

👉 Get started

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

Copilot

Pull request overview

Adds documentation for the new thread.ring_buffer.retry_limit input configuration option (retry attempts before dropping data when the threaded ring buffer is full).

Changes:

Documented thread.ring_buffer.retry_limit for tail, opentelemetry, prometheus-textfile, and blob inputs.
Described behavior (max retries, 100ms wait per retry) and default value (10).

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 1 comment.

File	Description
pipeline/inputs/tail.md	Adds `thread.ring_buffer.retry_limit` to the Tail input config table.
pipeline/inputs/opentelemetry.md	Adds `thread.ring_buffer.retry_limit` to the OpenTelemetry input config table.
pipeline/inputs/prometheus-textfile.md	Adds `thread.ring_buffer.retry_limit` to the Prometheus textfile input config table.
pipeline/inputs/blob.md	Adds `thread.ring_buffer.retry_limit` to the Blob input config table (but key prefix is inconsistent with adjacent entries).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

coderabbitai

Actionable comments posted: 1

🤖 Fix all issues with AI agents

In `@pipeline/inputs/blob.md`:
- Around line 24-26: The three ring buffer parameters must use the same
namespace; replace the incorrect parameter name thread.ring_buffer.retry_limit
with threaded.ring_buffer.retry_limit so all three read
threaded.ring_buffer.capacity, threaded.ring_buffer.window and
threaded.ring_buffer.retry_limit; update the occurrence of
thread.ring_buffer.retry_limit in blob.md to threaded.ring_buffer.retry_limit to
match the other inputs and maintain naming consistency.

coderabbitai

Actionable comments posted: 3

🤖 Fix all issues with AI agents

In `@pipeline/inputs/opentelemetry.md`:
- Line 45: Update the unit formatting in the description for
`thread.ring_buffer.retry_limit`: replace "100ms" with "100 ms" using a
non-breaking space so the number and unit stay together (i.e., change the text
in the table cell to use "100 ms"). Ensure only the formatting of the unit is
changed and the rest of the description remains unchanged.

In `@pipeline/inputs/prometheus-textfile.md`:
- Line 21: Update the text for the `thread.ring_buffer.retry_limit` description
to use a non‑breaking space between the number and unit: replace "100ms" with
"100\u00A0ms" so the unit follows the FluentBit.Units style guide and avoids
line breaks (target the description string containing
`thread.ring_buffer.retry_limit`).

In `@pipeline/inputs/tail.md`:
- Line 50: Update the unit formatting for the `thread.ring_buffer.retry_limit`
description by replacing the hard space in "100ms" with a non-breaking space so
it reads "100\u00A0ms" (or use the HTML entity `&nbsp;` if appropriate for the
Markdown renderer); locate the table cell containing the text "Each retry waits
100ms." and change it to "Each retry waits 100\u00A0ms." to comply with the
FluentBit.Units style guide.

eschabell · 2026-01-31T15:18:52Z

@jinyongchoi the patch for the other config threaded* parameter fix is now causing conflicts here, can you resolve?

jinyongchoi · 2026-01-31T16:27:28Z

@jinyongchoi the patch for the other config threaded* parameter fix is now causing conflicts here, can you resolve?

Rebased on latest master to resolve conflicts caused by the threaded.* → thread.* parameter rename.
Also reordered thread.ring_buffer.retry_limit to maintain alphabetical sorting in all four plugin pages.
Thanks!

eschabell

@jinyongchoi I'm not sure I see the need to use   for the spacing? Can you remove that please?

jinyongchoi · 2026-02-04T10:30:41Z

@jinyongchoi I'm not sure I see the need to use   for the spacing? Can you remove that please?

Removed. Thanks for the feedback!

eschabell

Looks good to me now, just waiting on code PR merge.

eschabell · 2026-05-15T08:11:33Z

@jinyongchoi resolved the conflicts, waiting on code PR merge.

Add documentation for the new 'thread.ring_buffer.retry_limit' configuration option to the following input plugin pages: - tail - opentelemetry - prometheus-textfile - blob This option controls the maximum number of retry attempts when the ring buffer is full before dropping data. Each retry waits 100ms (hardcoded). The default value is 10. Refs: fluent/fluent-bit#113934 Signed-off-by: jinyong.choi <inimax801@gmail.com>

jinyongchoi · 2026-05-15T08:56:06Z

@jinyongchoi resolved the conflicts, waiting on code PR merge.

Rebased onto latest master to resolve the new conflicts from recent doc cleanups. Thanks!

Copilot AI review requested due to automatic review settings January 28, 2026 00:50

jinyongchoi requested review from a team and eschabell as code owners January 28, 2026 00:50

Copilot started reviewing on behalf of jinyongchoi January 28, 2026 00:50 View session

Copilot AI reviewed Jan 28, 2026

View reviewed changes

Comment thread pipeline/inputs/blob.md Outdated

coderabbitai Bot reviewed Jan 28, 2026

View reviewed changes

Comment thread pipeline/inputs/blob.md Outdated

jinyongchoi force-pushed the docs/add-ring-buffer-retry-limit-option branch from 0a251c6 to ce45d76 Compare January 28, 2026 00:55

coderabbitai Bot reviewed Jan 28, 2026

View reviewed changes

Comment thread pipeline/inputs/opentelemetry.md Outdated

Comment thread pipeline/inputs/prometheus-textfile.md Outdated

Comment thread pipeline/inputs/tail.md Outdated

jinyongchoi force-pushed the docs/add-ring-buffer-retry-limit-option branch 3 times, most recently from 92f8e47 to 963dfda Compare January 28, 2026 01:45

eschabell self-assigned this Jan 31, 2026

eschabell added waiting-on-code-merge 5.0 labels Jan 31, 2026

eschabell added conflict Waiting on conflict to be resolved by contributor waiting-on-review Waiting on a review from mainteners labels Jan 31, 2026

jinyongchoi force-pushed the docs/add-ring-buffer-retry-limit-option branch from 963dfda to a69a897 Compare January 31, 2026 16:24

eschabell removed conflict Waiting on conflict to be resolved by contributor waiting-on-review Waiting on a review from mainteners labels Feb 4, 2026

eschabell requested changes Feb 4, 2026

View reviewed changes

eschabell added the waiting-on-review Waiting on a review from mainteners label Feb 4, 2026

jinyongchoi force-pushed the docs/add-ring-buffer-retry-limit-option branch from a69a897 to 3e27ed9 Compare February 4, 2026 10:26

patrick-stephens requested a review from eschabell February 4, 2026 10:48

patrick-stephens approved these changes Feb 4, 2026

View reviewed changes

eschabell approved these changes Feb 7, 2026

View reviewed changes

eschabell removed the waiting-on-review Waiting on a review from mainteners label Feb 7, 2026

eschabell removed the 5.0 label Apr 1, 2026

jinyongchoi force-pushed the docs/add-ring-buffer-retry-limit-option branch from f5c57b6 to 4551cf0 Compare May 15, 2026 08:53

Conversation

jinyongchoi commented Jan 28, 2026 • edited by coderabbitai Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary by CodeRabbit

Uh oh!

coderabbitai Bot commented Jan 28, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Reviews paused

Walkthrough

Changes

Sequence Diagram(s)

Estimated code review effort

Possibly related PRs

Suggested labels

Suggested reviewers

Poem

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

coderabbitai Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

coderabbitai Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

eschabell commented Jan 31, 2026

Uh oh!

jinyongchoi commented Jan 31, 2026

Uh oh!

eschabell left a comment

Choose a reason for hiding this comment

Uh oh!

jinyongchoi commented Feb 4, 2026

Uh oh!

eschabell left a comment

Choose a reason for hiding this comment

Uh oh!

eschabell commented May 15, 2026

Uh oh!

jinyongchoi commented May 15, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

jinyongchoi commented Jan 28, 2026 •

edited by coderabbitai Bot

Loading

coderabbitai Bot commented Jan 28, 2026 •

edited

Loading